home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / APW.ORCA.Cmds / Gregs.APW.Utils / Documentation / DumpFile < prev    next >
Encoding:
Text File  |  1990-07-19  |  2.4 KB  |  76 lines  |  [TEXT/pdos]
  1. DumpFile -- display contents of an arbitrary file
  2.  
  3. Syntax      DumpFile [options...] filename
  4.  
  5. Description DumpFile lets your display the contents of the resource fork or the
  6.             data fork of a file in a variety of formats.
  7.  
  8. Input       DumpFile does not read standard input.  Only 1 filename may be
  9.             specified, and no wildcard characters are accepted.
  10.  
  11. Output      DumpFile writes its output to standard output.
  12.  
  13. Diagnostics Errors and warnings are written to diagnostic output.  Progress
  14.             information is also written to diagnostic output with the -p
  15.             option.
  16.  
  17. Status      DumpFile may return the following status codes:
  18.  
  19.             0   No errors
  20.             2   Fatal error
  21.             -1  User abort
  22.  
  23. Options     -rf     Display the resource fork of the file (default is data
  24.                     fork)
  25.  
  26.             -a      Suppress display of ASCII character values
  27.  
  28.             -h      Suppress display of hexadecimal characters
  29.  
  30.             -o      Suppress display of file offsets
  31.  
  32.             -w nn   Display width of nn bytes on each line of output
  33.  
  34.             -g nn   Group nn bytes together without intervening spaces
  35.  
  36.             -p      Write progress information (such as the name of the file
  37.                     being dumped and the version of DumpFile) to diagnostic
  38.                     output
  39.  
  40.             -r byte1[,byteN]
  41.                     Display only the byte range from byte1 to byteN.
  42.  
  43. Examples    DumpFile -p ATestFile
  44.  
  45.             Formats the data fork of the file "ATestFile" and writes its
  46.             contents to standard output.  This output has the following format:
  47.  
  48. DumpFile - Version 1.0
  49. Copyright (c) 1990, Apple Computer, Inc.
  50. All Rights Reserved
  51. File                 : ATestFile
  52. Data Fork Length     : 21
  53. Resource Fork Length : 0
  54.  
  55. Dumping Data Fork from offset 0 to 21
  56.  
  57.    0: 54 68 69 73 20 69 73 20 61 20 74 65 73 74 20 66     This is a test f
  58.   10: 69 6C 65 2E 0D                                      ile..
  59.  
  60.  
  61.             DumpFile -w 12 -g 4 ATestFile
  62.  
  63.             Formats the data fork of the file "ATestFile" and writes its
  64.             contents to standard output, grouping 4 bytes at a time and
  65.             displaying 12 bytes per line.  This output has the following
  66.             format:
  67.  
  68. File                 : ATestFile
  69. Data Fork Length     : 21
  70. Resource Fork Length : 0
  71.  
  72. Dumping Data Fork from offset 0 to 21
  73.  
  74.    0: 54686973 20697320 61207465    This is a te
  75.    C: 73742066 696C652E 0D          st file..
  76.